home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / cli / requestlist.lha / RequestList.txt < prev   
Text File  |  1995-09-16  |  3KB  |  113 lines
  1.                              RequestList v1.0
  2.                                 Adam Dawes
  3.                            15th September, 1995
  4.  
  5.  
  6.  
  7. What is RequestList?
  8. ======================
  9.  
  10. RequestList is a little utility designed to complement the Commodore
  11. utilities, 'RequestChoice' and 'RequestFile', primarily of use in AmigaDos
  12. shell scripts.
  13.  
  14. The programs displays a requester containing a list of text items, taken
  15. from a file you specify when you run it. When the user selects one of the
  16. text items by clicking on it, the line number for that entry will be
  17. printed to stdout (so it's very convenient to redirect the output of
  18. RequestList to an environment variable).
  19.  
  20. If the user closes the window instead of clicking on a list item, the value
  21. '-1' is returned.
  22.  
  23.  
  24.  
  25. Using RequestList
  26. =================
  27.  
  28. The parameters for RequestList are as follows:
  29.  
  30.   RequestList <title> <listfile> [pubscreen=]
  31.  
  32.          Title: The name that will be given to the window that opens
  33.                 containing the list requester. (Required)
  34.       Listfile: The name of a file containing carriage-return seperated
  35.                 items to be included within the list.
  36.      PubScreen: Allows you to specify a public screen for the requester to
  37.                 open upon.
  38.  
  39.  
  40.  
  41. Requirements
  42. ============
  43.  
  44. RequestList requires Kickstart 2 or greater.
  45.  
  46.  
  47.  
  48. Legal stuff
  49. ===========
  50.  
  51. RequestList is freeware. It may be distributed however and wherever you
  52. like.
  53.  
  54. I accept no responsibility for any damage done to your system, directly or
  55. indirectly, as a result of using RequestList. You use the program entirely
  56. at your own risk.
  57.  
  58.  
  59.  
  60. History
  61. =======
  62.  
  63.   v1.0 (39.0)
  64.  
  65.         Initial release.
  66.  
  67.  
  68.  
  69. Bugs
  70. ====
  71.  
  72. I've only tested this on a KS3.0 A1200. I have a suspicion that the
  73. listview might not look right on KS2.0, please contact me if you have any
  74. problems with it.
  75.  
  76. Also, RequestList is completely *non*-font-sensitive, and fonts with
  77. heights other than 8 pixels will probably generate a few minor problems.
  78. Again, if this occurs and you need it fixed, send me some email.
  79.  
  80.  
  81.  
  82. Contacting the author
  83. =====================
  84.  
  85. Please do write to me if you like RequestList or if you have any problems
  86. with it or suggestions for a new version. I can't promise to reply quickly
  87. if you write via snail-mail, but I will always reply to email messages. I
  88. can be contacted at:
  89.  
  90.   InterNet
  91.      ad32@brighton.ac.uk
  92.  
  93.   FidoNet
  94.      Adam Dawes@2:441/93.5
  95.  
  96.   SnailMail
  97.      Adam Dawes
  98.      47 Friar Road
  99.      Brighton
  100.      BN1 6NH
  101.      England
  102.  
  103.  
  104.  
  105. See Also
  106. ========
  107.  
  108. I have also written another utility that complements this and the Commodore
  109. 'Request' commands. 'RequestString' is available from Aminet, and provides
  110. a simple and easy way to prompt the user to enter some text from a script.
  111. Amongst other things, the requester can have a default string already
  112. entered, and may have text entered invisibly (for passwords, etc.).
  113.